home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 1 / Meeting Pearls Vol 1 (1994).iso / installed_progs / gfx / daggex / docs / clients / xrdb.doc < prev    next >
Encoding:
Text File  |  1994-06-04  |  12.1 KB  |  331 lines
  1.  
  2.  
  3.  
  4. XRDB(1)                                                   XRDB(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        xrdb - X server resource database utility
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxrrddbb [-option ...] [_f_i_l_e_n_a_m_e]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        _X_r_d_b   is   used  to  get  or  set  the  contents  of  the
  15.        RESOURCE_MANAGER property on the root window of screen  0,
  16.        or the SCREEN_RESOURCES property on the root window of any
  17.        or all screens, or everything combined.   You  would  nor-
  18.        mally run this program from your X startup file.
  19.  
  20.        Most    X    clients    use   the   RESOURCE_MANAGER   and
  21.        SCREEN_RESOURCES properties to get user preferences  about
  22.        color,  fonts,  and  so  on for applications.  Having this
  23.        information in the server (where it is  available  to  all
  24.        clients)  instead of on disk, solves the problem in previ-
  25.        ous versions of X that required you to  maintain  _d_e_f_a_u_l_t_s
  26.        files on every machine that you might use.  It also allows
  27.        for dynamic changing of defaults without editing files.
  28.  
  29.        The RESOURCE_MANAGER property is used for  resources  that
  30.        apply to all screens of the display.  The SCREEN_RESOURCES
  31.        property on each screen specifies additional (or  overrid-
  32.        ing) resources to be used for that screen.  (When there is
  33.        only one screen, SCREEN_RESOURCES is  normally  not  used,
  34.        all  resources  are  just  placed  in the RESOURCE_MANAGER
  35.        property.)
  36.  
  37.        The file specified by _f_i_l_e_n_a_m_e (or the contents from stan-
  38.        dard  input  if  -  or no filename is given) is optionally
  39.        passed through the C preprocessor with the following  sym-
  40.        bols  defined,  based  on  the  capabilities of the server
  41.        being used:
  42.  
  43.        BBIITTSS__PPEERR__RRGGBB==nnuumm
  44.                the number of significant bits  in  an  RGB  color
  45.                specification.  This is the log base 2 of the num-
  46.                ber of distinct shades of each  primary  that  the
  47.                hardware  can  generate.   Note that it usually is
  48.                not related to PLANES.
  49.  
  50.        CCLLAASSSS==vviissuuaallccllaassss
  51.                one of StaticGray, GrayScale, StaticColor, Pseudo-
  52.                Color, TrueColor, DirectColor.  This is the visual
  53.                class of the root window of the default screen.
  54.  
  55.        CCOOLLOORR   defined only if CLASS is one of StaticColor, Pseu-
  56.                doColor, TrueColor, or DirectColor.
  57.  
  58.        HHEEIIGGHHTT==nnuumm
  59.                the height of the default screen in pixels.
  60.  
  61.  
  62.  
  63.  
  64. X Version 11                Release 5                           1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XRDB(1)                                                   XRDB(1)
  71.  
  72.  
  73.        SSEERRVVEERRHHOOSSTT==hhoossttnnaammee
  74.                the  hostname  portion of the display to which you
  75.                are connected.
  76.  
  77.        HHOOSSTT==hhoossttnnaammee
  78.                the same as SSEERRVVEERRHHOOSSTT.
  79.  
  80.        CCLLIIEENNTTHHOOSSTT==hhoossttnnaammee
  81.                the name of the host on which _x_r_d_b is running.
  82.  
  83.        PPLLAANNEESS==nnuumm
  84.                the number of bit planes (the depth) of  the  root
  85.                window of the default screen.
  86.  
  87.        RREELLEEAASSEE==nnuumm
  88.                the  vendor  release  number  for the server.  The
  89.                interpretation of this number will vary  depending
  90.                on VENDOR.
  91.  
  92.        RREEVVIISSIIOONN==nnuumm
  93.                the  X  protocol  minor  version supported by this
  94.                server (currently 0).
  95.  
  96.        VVEERRSSIIOONN==nnuumm
  97.                the X protocol major  version  supported  by  this
  98.                server (should always be 11).
  99.  
  100.        VVEENNDDOORR==vveennddoorr
  101.                a string specifying the vendor of the server.
  102.  
  103.        WWIIDDTTHH==nnuumm
  104.                the width of the default screen in pixels.
  105.  
  106.        XX__RREESSOOLLUUTTIIOONN==nnuumm
  107.                the  x  resolution of the default screen in pixels
  108.                per meter.
  109.  
  110.        YY__RREESSOOLLUUTTIIOONN==nnuumm
  111.                the y resolution of the default screen  in  pixels
  112.                per meter.
  113.  
  114.        Lines  that begin with an exclamation mark (!) are ignored
  115.        and may be used as comments.
  116.  
  117.        Note that since _x_r_d_b can read from standard input, it  can
  118.        be  used to the change the contents of properties directly
  119.        from a terminal or from a shell script.
  120.  
  121. OOPPTTIIOONNSS
  122.        _x_r_d_b program accepts the following options:
  123.  
  124.        --hheellpp   This option (or any unsupported option) will cause
  125.                a  brief  description of the allowable options and
  126.                parameters to be printed.
  127.  
  128.  
  129.  
  130. X Version 11                Release 5                           2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XRDB(1)                                                   XRDB(1)
  137.  
  138.  
  139.        --ddiissppllaayy _d_i_s_p_l_a_y
  140.                This option specifies the X server to be used; see
  141.                _X_(_1_).  It also specifies the screen to use for the
  142.                _-_s_c_r_e_e_n option, and it specifies the  screen  from
  143.                which  preprocessor  symbols  are  derived for the
  144.                _-_g_l_o_b_a_l option.
  145.  
  146.        --aallll    This option indicates  that  operation  should  be
  147.                performed on the screen-independent resource prop-
  148.                erty (RESOURCE_MANAGER), as well  as  the  screen-
  149.                specific   property  (SCREEN_RESOURCES)  on  every
  150.                screen of the display.  For example, when used  in
  151.                conjunction with _-_q_u_e_r_y, the contents of all prop-
  152.                erties are output.   For  _-_l_o_a_d  and  _-_m_e_r_g_e,  the
  153.                input file is processed once for each screen.  The
  154.                resources which occur in common in the output  for
  155.                every  screen are collected, and these are applied
  156.                as the screen-independent resources.  The  remain-
  157.                ing resources are applied for each individual per-
  158.                screen property.  This the default mode of  opera-
  159.                tion.
  160.  
  161.        --gglloobbaall This  option  indicates  that the operation should
  162.                only  be  performed  on   the   screen-independent
  163.                RESOURCE_MANAGER property.
  164.  
  165.        --ssccrreeeenn This  option  indicates  that the operation should
  166.                only be performed on the SCREEN_RESOURCES property
  167.                of the default screen of the display.
  168.  
  169.        --ssccrreeeennss
  170.                This option indicates that the operation should be
  171.                performed on the SCREEN_RESOURCES property of each
  172.                screen  of the display.  For _-_l_o_a_d and _-_m_e_r_g_e, the
  173.                input file is processed for each screen.
  174.  
  175.        --nn      This option indicates that changes to  the  speci-
  176.                fied  properties  (when used with _-_l_o_a_d or _-_m_e_r_g_e)
  177.                or to the resource file  (when  used  with  _-_e_d_i_t)
  178.                should be shown on the standard output, but should
  179.                not be performed.
  180.  
  181.        --qquuiieett  This option indicates that warning about duplicate
  182.                entries should not be displayed.
  183.  
  184.        --ccpppp _f_i_l_e_n_a_m_e
  185.                This  option  specifies the pathname of the C pre-
  186.                processor program to be used.  Although  _x_r_d_b  was
  187.                designed  to  use  CPP, any program that acts as a
  188.                filter and accepts the -D, -I, and -U options  may
  189.                be used.
  190.  
  191.        --nnooccpppp  This option indicates that _x_r_d_b should not run the
  192.                input file through a preprocessor  before  loading
  193.  
  194.  
  195.  
  196. X Version 11                Release 5                           3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XRDB(1)                                                   XRDB(1)
  203.  
  204.  
  205.                it into properties.
  206.  
  207.        --ssyymmbboollss
  208.                This  option  indicates  that the symbols that are
  209.                defined for the  preprocessor  should  be  printed
  210.                onto the standard output.
  211.  
  212.        --qquueerryy  This option indicates that the current contents of
  213.                the specified properties should  be  printed  onto
  214.                the standard output.  Note that since preprocessor
  215.                commands in the input resource file  are  part  of
  216.                the  input  file,  not  part of the property, they
  217.                won't appear in the output from this option.   The
  218.                --eeddiitt  option can be used to merge the contents of
  219.                properties back into the input resource file with-
  220.                out damaging preprocessor commands.
  221.  
  222.        --llooaadd   This  option  indicates  that  the input should be
  223.                loaded as the new value of the  specified  proper-
  224.                ties,  replacing whatever was there (i.e.  the old
  225.                contents  are  removed).   This  is  the   default
  226.                action.
  227.  
  228.        --mmeerrggee  This  option  indicates  that  the input should be
  229.                merged with, instead  of  replacing,  the  current
  230.                contents  of  the specified properties.  Note that
  231.                this option does a lexicographic sorted  merge  of
  232.                the two inputs, which is almost certainly not what
  233.                you want, but remains for backward  compatibility.
  234.  
  235.        --rreemmoovvee This  option  indicates that the specified proper-
  236.                ties should be removed from the server.
  237.  
  238.        --rreettaaiinn This option indicates that the  server  should  be
  239.                instructed  not  to  reset  if  _x_r_d_b  is the first
  240.                client.  This never be necessary under normal con-
  241.                ditions,  since  _x_d_m  and  _x_i_n_i_t always act as the
  242.                first client.
  243.  
  244.        --eeddiitt _f_i_l_e_n_a_m_e
  245.                This option indicates that  the  contents  of  the
  246.                specified  properties  should  be  edited into the
  247.                given file, replacing any  values  already  listed
  248.                there.   This  allows  you to put changes that you
  249.                have made to your defaults back into your resource
  250.                file,  preserving  any  comments  or  preprocessor
  251.                lines.
  252.  
  253.        --bbaacckkuupp _s_t_r_i_n_g
  254.                This option specifies a suffix to be  appended  to
  255.                the  filename used with --eeddiitt to generate a backup
  256.                file.
  257.  
  258.        --DD_n_a_m_e  This option is passed through to the  preprocessor
  259.  
  260.  
  261.  
  262. X Version 11                Release 5                           4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. XRDB(1)                                                   XRDB(1)
  269.  
  270.  
  271.                and  is used to define symbols for use with condi-
  272.                tionals such as _#_i_f_d_e_f_.
  273.  
  274.        --UU_n_a_m_e  This option is passed through to the  preprocessor
  275.                and is used to remove any definitions of this sym-
  276.                bol.
  277.  
  278.        --II_d_i_r_e_c_t_o_r_y
  279.                This option is passed through to the  preprocessor
  280.                and  is  used to specify a directory to search for
  281.                files that are referenced with _#_i_n_c_l_u_d_e_.
  282.  
  283. FFIILLEESS
  284.        Generalizes _~_/_._X_d_e_f_a_u_l_t_s files.
  285.  
  286. SSEEEE AALLSSOO
  287.        X(1), Xlib Resource  Manager  documentation,  Xt  resource
  288.        documentation
  289.  
  290. EENNVVIIRROONNMMEENNTT
  291.        DDIISSPPLLAAYY to figure out which display to use.
  292.  
  293. BBUUGGSS
  294.        The  default  for  no arguments should be to query, not to
  295.        overwrite, so that it is consistent with other programs.
  296.  
  297. CCOOPPYYRRIIGGHHTT
  298.        Copyright 1991, Digital Equipment Corporation and MIT.
  299.  
  300. AAUUTTHHOORRSS
  301.        Bob Scheifler, Phil Karlton, rewritten from  the  original
  302.        by Jim Gettys
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328. X Version 11                Release 5                           5
  329.  
  330.  
  331.